home *** CD-ROM | disk | FTP | other *** search
/ Java Programmer's Toolkit / Java Programmer's Toolkit.iso / hotjava / classsrc / java / io / fileou~1.jav < prev    next >
Encoding:
Text File  |  1995-08-11  |  3.6 KB  |  134 lines
  1. /*
  2.  * @(#)FileOutputStream.java    1.13 95/05/21 Arthur van Hoff
  3.  *
  4.  * Copyright (c) 1994 Sun Microsystems, Inc. All Rights Reserved.
  5.  *
  6.  * Permission to use, copy, modify, and distribute this software
  7.  * and its documentation for NON-COMMERCIAL purposes and without
  8.  * fee is hereby granted provided that this copyright notice
  9.  * appears in all copies. Please refer to the file "copyright.html"
  10.  * for further important copyright and licensing information.
  11.  *
  12.  * SUN MAKES NO REPRESENTATIONS OR WARRANTIES ABOUT THE SUITABILITY OF
  13.  * THE SOFTWARE, EITHER EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED
  14.  * TO THE IMPLIED WARRANTIES OF MERCHANTABILITY, FITNESS FOR A
  15.  * PARTICULAR PURPOSE, OR NON-INFRINGEMENT. SUN SHALL NOT BE LIABLE FOR
  16.  * ANY DAMAGES SUFFERED BY LICENSEE AS A RESULT OF USING, MODIFYING OR
  17.  * DISTRIBUTING THIS SOFTWARE OR ITS DERIVATIVES.
  18.  */
  19.  
  20. package java.io;
  21. import java.io.File;
  22.  
  23. /**
  24.  * File output stream; can be constructed from
  25.  * a file descriptor or a file name.
  26.  * @see    FileInputStream
  27.  * @see    File
  28.  * @version     1.13, 21 May 1995
  29.  * @author    Arthur van Hoff
  30.  */
  31. public
  32. class FileOutputStream extends OutputStream {
  33.     /**
  34.      * The system dependent file descriptor.
  35.      */
  36.     private int fd = -1;
  37.  
  38.     /**
  39.      * Creates an output file given a file name.
  40.      * @param name the file name (very system dependent)
  41.      * @exception IOException i/o error occurred, file not found
  42.      */
  43.     public FileOutputStream(String name) {
  44.     this.fd = open(name);
  45.     }
  46.     
  47.     /**
  48.      * Creates an output file given a file descriptor.
  49.      * @param fd    the file descriptor (very system dependent)
  50.      * @exception IOException i/o error occurred
  51.      */
  52.     public FileOutputStream(int fd) {
  53.     this.fd = openfd(fd);
  54.     }
  55.     
  56.     /**
  57.      * Creates an output file given a File object.
  58.      * @param file the file to be opened for reading
  59.      * @exception IOException i/o error occurred, file not found
  60.      */
  61.     public FileOutputStream(File file) {
  62.     this(file.getPath());
  63.     }
  64.     
  65.     /**
  66.      * Opens a file for writing
  67.      */
  68.     private native int open(String name);
  69.  
  70.     /**
  71.      * Uses a file descriptor for writing.
  72.      */
  73.     private native int openfd(int fd);
  74.  
  75.     /**
  76.      * Write a byte. Will block until the byte is actually
  77.      * written.
  78.      * @exception IOException i/o error occurred
  79.      */
  80.     public native void write(int b);
  81.  
  82.     /**
  83.      * Writes bytes
  84.      */
  85.     private native void writeBytes(byte b[], int off, int len);
  86.  
  87.     /**
  88.      * Writes an array of bytes. Will block until the bytes
  89.      * are actually written.
  90.      * @param b    the data to be written
  91.      * @exception IOException i/o error occurred
  92.      */
  93.     public void write(byte b[]) {
  94.     writeBytes(b, 0, b.length);
  95.     }
  96.  
  97.     /**
  98.      * Writes a sub array of bytes. To be efficient it should
  99.      * be overridden in a subclass. 
  100.      * @param b    the data to be written
  101.      * @param off    the start offset in the data
  102.      * @param len    the number of bytes that are written
  103.      * @exception IOException i/o error occurred
  104.      */
  105.     public void write(byte b[], int off, int len) {
  106.     writeBytes(b, off, len);
  107.     }
  108.  
  109.     /**
  110.      * Closes the stream. This method must be called
  111.      * to release any resources associated with the
  112.      * stream.
  113.      * @exception IOException i/o error occurred
  114.      */
  115.     public synchronized native void close();
  116.  
  117.     /**
  118.      * Returns the file descriptor associated with this stream.
  119.      */
  120.     public final int getFD() {
  121.     return fd;
  122.     }
  123.  
  124.     /**
  125.      * Close the stream when garbage is collected.
  126.      */
  127.     protected void finalize() {
  128.         try {
  129.         close();
  130.     } catch (Exception e) {
  131.     }    
  132.     }
  133. }
  134.